Inside Macintosh: Telephony /

Chapter 5 - Telephone Manager Messages / Telephone Manager Message Reference

Application-Defined Message Functions /

MyDNMsgHandler

Handles directory number messages passed to it by the Telephone Manager.

pascal void MyDNMsgHandler (
                     TELDNHandle hTELDN,
                     long msg,
                     short mtype, 
                     short value, 
                     ConstStr255Param rmtDN,
                     ConstStr255Param rmtName,
                     ConstStr255Param rmtSubaddress,
                     long globals);

hTELDN

A handle to the directory number record for the directory number that originated the message.

msg

A value indicating the directory number message to be processed. See "Directory Number Messages" on page 5-12 for possible values for this parameter.

mtype

A constant used by some messages to further categorize the type of activity that is generating the event.

value

A constant used by some messages to provide specific details concerning the state of an activity.

rmtDN

The directory number being called. If this information is not applicable or not available, this parameter is set to nil.

rmtName

The name of the party being called. If this information is not applicable or not available, this parameter is set to nil.

rmtSubaddress

The subaddress being called. If this information is not applicable or not available, this parameter is set to nil.

globals

A long integer for your use. You specify this value when you register the message handler, and the Telephone Manager passes the value unchanged to your message handler. You can use this value, for example, to access your application's global variables.

DESCRIPTION

Once you register your message handler and specify which messages to it should receive, the Telephone Manager passes those messages to your message handler.

SEE ALSO

Use the TELDNMsgHand function (page 5-51) to register a directory number message handler.

Directory number messages are described in "Directory Number Messages" on page 5-12.